Book Contents

Options on the Label tab of a button object's Properties dialog box

The following table shows the options on the Label tab of a button object's Properties dialog box.

Options

Descriptions

Caption

Specify the text for the object. The text appears on the face of the object to give the operator information about what the object does or about the current state.

Insert Variable

Click this button to select the type of variable to be inserted.

Font

Select the font to use for the caption.

Size

Select the font size to use for the caption or message.

Bold, Italic, Underline

Select a font style for the caption or message, if needed.

Caption color

This box shows the current text color for the caption. Click it to select another color.

Caption back color

This box shows the current background color for the caption. Click it to select another color.

If the caption background style is transparent, the application does not use this caption background color.

Caption blink

Select this check box if you want the caption to blink at run time. The caption blinks twice per second.

Word wrap

Select this check box if you want the text to continue on the next line at the beginning of a new word.

If this check box is cleared, the text continues on the next line whenever the maximum text length is reached, even if this occurs in the middle of a word or number. The maximum text length depends on the width of the object and the font size.

Alignment

Select how you want the caption to be positioned on the object.

If the object shape is circle or ellipse, the position is relative to the button’s bounding box.

Caption back style

Select whether the caption’s background is solid or transparent.

If you select Transparent, the object’s background is not filled in and any objects behind it show through.

Image settings

Specify the image to show on the button.

Image

Specify the name of the image file to show on the button, or click the Browse button to open the Image Browser.

The image appears on the face of the object to give the operator information about what the object does or about the current state.

Before you can place an image on the object, you must import the image into your project.

Image back style

This property applies to monochrome and color images. Use it to set the background style to Solid or Transparent.

If Image back style is Transparent:

  • For monochrome images, the background will be transparent .
  • For color images that are not PNG with Alpha channel, any parts of the images that are black will be transparent.

     

Image color

Specify the color that the image is drawn in; that is, the foreground color. It applies only to monochrome images.

Click it to select another color.

Image back color

This property applies to monochrome images. It determines the color of the background the image is drawn on. Click the colored box to select another color.

If the Image back style is Transparent, the background of the image will be transparent.

Image blink

Select this check box to let the monochrome image blink at run time. The image blinks twice per second.

Image scaled

Select this check box to let the application resize the image to fit the object. If the object shape is circle or ellipse, the image is resized to fit in the object’s bounding box and clipped to fit the object’s shape.

If this is not selected, the image is first aligned using the Alignment setting, and then, if larger than the object, the image is clipped to fit the object.

Alignment

Specify how you want the image to be positioned on the object.

If the object shape is circle or ellipse, the position is relative to the object’s bounding box.

See also

Set up a caption and image for a button

The Label tab of a button object's Properties dialog box

Bounding box